home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / CVR140.ARJ / READ.ME < prev    next >
Text File  |  1991-09-09  |  13KB  |  272 lines
  1. CVR - The Disk Cover Utility
  2. Version 1.40 - (C)Copyright Larry J. Bristol 1990-1991
  3.  
  4. ***********************************************************************
  5. *************** Distribution Files ************************************
  6. ***********************************************************************
  7. You should have received the following files from the distribution of
  8. the CVR program:
  9.     CVR.DOC ------ how to use and customize CVR
  10.     CVR.EXE ------ the executable program
  11.     CONFIG.BAT --- customization procedure
  12.     READ.ME ------ you are reading it now
  13.     REGISTER.DOC - license registration order form
  14.  
  15. You should have received the following printer configuration files:
  16.     AUTHORS.CFG -- My personal configuration (Epson LQ-510)
  17.     EPSONFX.CFG -- Epson FX series
  18.     EPSONLQ.CFG -- Epson LQ series
  19.     IBMGRAPH.CFG - IBM Graphics (5151)
  20.     LASJET1P.CFG - HP LaserJet series
  21.     LASJET2P.CFG - HP LaserJet IIP series
  22.     OKI9293.CFG -- OkiData Microline 92/92 (without Plug'N Play)
  23.     PANSONIC.CFG - Panasonic KX-P1180/P1124 printers
  24.  
  25. You should have received the following customization script files,
  26. which correspond to the prepared configuration files above:
  27.     AUTHORS.SCR
  28.     EPSONFX.SCR
  29.     EPSONLQ.SCR
  30.     IBMGRAPH.SCR
  31.     LASJET1P.SCR
  32.     LASJET2P.SCR
  33.     OKI9293.SCR
  34.     PANSONIC.SCR
  35.  
  36. In addition, you should have the following sample customization script
  37. files:
  38.     DRIVES.SCR --- Change drive configuration script sample
  39.     PRTNAME.SCR -- Change printer device name script sample
  40.     EXAMPLE.SCR -- Complete configuration script example
  41.  
  42. ***********************************************************************
  43. *************** Self-Test Virus Protection ****************************
  44. ***********************************************************************
  45. The CVR program performs a complete self-test every time it is run to
  46. detect any form of modification such as an infection by a computer
  47. virus.  If any modification is detected, the program will display the
  48. following message and refuse to execute any further:
  49.      Program integrity has been compromised.
  50. If you should suddenly start receiving this message and you cannot
  51. account for any modifications to the program files, it is a strong
  52. possibility that your system may be infected by a virus.  You should
  53. perform an integrity check of your entire computer system to look for
  54. other programs infected by a virus.
  55.  
  56. Note that ANY modification of the CVR program files will result in this
  57. condition.  This means that program file compression facilities (such
  58. as PKLITE) cannot be used on the CVR program files.  In order to
  59. execute the CVR program, you will have to install a new, unmodified
  60. copy.
  61.  
  62. ***********************************************************************
  63. *************** Evaluation Period *************************************
  64. ***********************************************************************
  65. During your evaluation of the CVR program (prior to the entry of a
  66. valid license registration ID), there are a few special restrictions on
  67. the CVR program.  These restrictions do not apply to a licensed copy of
  68. the program.
  69.  
  70. Unlicensed copies of the CVR program may be used for evaluation
  71. purposes for a maximum of 30 days.  This 30 day evaluation period
  72. begins when the CVR program is executed for the first time on your
  73. computer.  Each time it is run, CVR will tell you how many days remain
  74. in the evaluation period.  Once this period has expired, the program
  75. will no longer execute.
  76.  
  77. The program execution file (CVR.EXE) and configuration file (CVR.CFG)
  78. must not be given the "read-only" or "system" file attributes, and they
  79. must not placed on a write-protected disk.  One of the following error
  80. messages may result, and the program will refuse to execute:
  81.      Program integrity has been compromised.
  82.      Error opening program file "-filename-".
  83.      Error closing program file "-filename-".
  84.  
  85. The system clock must be set to the correct date and time.  If not set
  86. properly, CVR will display the following error message and will refuse
  87. to execute:
  88.      You must set your system clock properly.
  89.  
  90. The CVR program performs a complete self-test every time it is run, to
  91. detect any form of modification.  For non-licensed copies of the
  92. program, a few extra tests are performed to detect tampering with the
  93. mechanisms used to limit the length of the software evaluation period.
  94. If tampering is detected, the following error message will result, and
  95. the program will refuse to execute:
  96.      Program integrity has been compromised.
  97.  
  98. ***********************************************************************
  99. *************** Customization Addresses *******************************
  100. ***********************************************************************
  101. The offsets (as used by DEBUG) of the customization areas within the
  102. CVR configuration file (CVR.CFG) are as follows:
  103.     0120 - default diskette drive ID
  104.     0121 - default for sort/nosort
  105.     0128 - diskette drive configuration table
  106.     0130 - name of the print output device
  107.     0200 - Initialize printer string
  108.     0220 - Reset printer string
  109.     0240 - Form feed string
  110.     0250 - SET to 8 lines/inch string
  111.     0260 - RESET from 8 lines/inch string
  112.     0270 - SET to condensed mode string
  113.     0280 - RESET from condensed mode string
  114.     0290 - SET to double wide characters string
  115.     02A0 - RESET from double wide characters string
  116.     02B0 - SET to emphasized mode string
  117.     02C0 - RESET from emphasized mode string
  118.     02D0 - SET to underlined mode string
  119.     02E0 - RESET from underlined mode string
  120.  
  121. ***********************************************************************
  122. *************** Thoughts on Customization *****************************
  123. ***********************************************************************
  124. You may need to "fiddle" with the print code strings in order to get
  125. them to work exactly the way you like. Experimentation might be the
  126. order of the day.  Note that I do not have the opportunity to test all
  127. of the script files personally - please let me know if there you
  128. encounter a problem.
  129.  
  130. A lot of the programming in CVR is to make sure that the columns and
  131. borders are aligned.  The program assumes that the printer code strings
  132. do not take up any print positions, so if you include printable
  133. characters within a string, there will probably be an alignment error.
  134.  
  135. It dawns on me that there might be a printer out there that cannot
  136. print double sized condensed characters (8.55/inch).  If you have one
  137. those, the title line (containing the volume label) will probably not
  138. print correctly.  If you have this problem, your "SET to double wide
  139. chars" string should be set to a null string (hex "00" in the first
  140. byte), and your "RESET from double wide characters" string should be
  141. set to a string of twelve (12) blanks ("20 20 20 ...").  This will
  142. cause CVR to print the volume label in normal size characters, but the
  143. data will at least be aligned properly.  (The LASJET1P.CFG
  144. configuration uses this technique.)
  145.  
  146. An interesting problem that pops up when programming in "C" is what to
  147. do when you want a character string to actually CONTAIN a byte of zero,
  148. instead of being terminated by one.  (Was there any doubt as to the
  149. language I use?)  This could create a problem if one of the printer
  150. code strings needs to have a byte of "00"; and sure enough the IBM 5151
  151. printer control code to turn off underlining needs it. My solution is
  152. to turn on the high order bit (using "80" instead of "00") and hope!
  153. While this technique has been tested on some printers, I don't have an
  154. IBM 5151 printer available to test this theory; maybe one of the two
  155. people who do will test it for me?  If it doesn't work right, just make
  156. both the "SET to underlined mode" and "RESET from underlined mode"
  157. strings null (put "00" in the first position); this just means that
  158. sub- directory names will not be underlined.  I guess anyone still
  159. using an IBM graphics printer probably doesn't use sub-directories,
  160. anyway!  (I *REALLY* have to stop being so derogatory!!)
  161.  
  162. I use this technique to customize the version of the program that I use
  163. personally so that it behaves differently than the way the program is
  164. distributed.  I use an Epson LQ-510 printer which supports several
  165. character sets (fonts).  By default, the printer will use the "Roman"
  166. character sets, but I would rather have my CVR sheets printed using
  167. "draft" mode.  So I have changed my "initialization" string to include
  168. the command to select draft mode (1B 78 80); note that the last byte of
  169. this string should be "00" according to the manual, but the "80" code
  170. works just fine.  In all likelihood, most printers will probably ignore
  171. the high bit of a control character, and this technique will work.
  172.  
  173. ***********************************************************************
  174. *************** Log of changes ****************************************
  175. ***********************************************************************
  176. 1.40 --- 09/08/91
  177.    Added the /SORT and /NOSORT options to provide the ability to sort
  178.    the file list into alphabetical order.
  179.  
  180.    Changed the separator character between the command switch name and
  181.    its value from a colon (:) to an equal sign (=).  The correct way to
  182.    specify the output printer is:
  183.         /PRINT=printer-name
  184.  
  185.    Starting with this version, CVR will perform a complete self-test
  186.    every time it is run in an attempt to detect modifications which
  187.    might result from infection by a computer virus.
  188.  
  189.    The printer file is now opened before the first diskette is
  190.    processed.  This means that if there is some condition with the
  191.    printer that needs your attention, the messages will appear sooner.
  192.  
  193.    Added some informational messages during processing to show what the
  194.    programming is doing as it works.  Just to satisfy curiosity.
  195.  
  196.    Made some performance enhancements to the way that diskettes are
  197.    read.  Diskettes are notoriously slow, so anything has got to help.
  198.    CVR will now read the file allocation table (FAT) for the diskette
  199.    only when necessary (to process sub-directories on the diskette).
  200.  
  201.    Starting with this version, CVR has a complete license registration
  202.    facility, and an attempt has been made to show that I am serious
  203.    about the 30 evaluation period.  This program represents a lot of
  204.    work, and it is well-worth the registration fee.
  205.  
  206.  
  207. 1.31 --- 08/25/91
  208.    Some idiot forgot to test the customization scripts!
  209.  
  210.    So while I was at it, I made CVR more DESQview aware.  Normally,
  211.    programs that access diskettes play havoc in a DESQview system by
  212.    grabbing the CPU and not letting other tasks get dispatched.  CVR
  213.    is tuned to release the CPU allowing a task switch to occur more
  214.    frequently.
  215.  
  216.  
  217. 1.30 --- 08/25/91
  218.    Moved all customization and configuration variables to an external
  219.    file.  This greatly simplifies customization!
  220.  
  221.    Created an interrupt controlled print driver for parallel printers
  222.    to speed processing, especially when running within multi-tasking
  223.    environments such as DESQview.
  224.  
  225.    Provided a parameter switch to allow specification of the output
  226.    printer.
  227.  
  228.    Note: Starting with this version, the CVR program file is changed to
  229.    CVR.EXE (instead of CVR.COM).  Users upgrading from a previous
  230.    version must delete CVR.COM when installing this release.
  231.  
  232.  
  233. 1.20 --- 01/01/91
  234.    Added a CVR sheet format suitable for 3-1/2 inch diskettes!  The
  235.    same problem that I used to have with 5-1/4 inch diskettes started
  236.    showing up with my 3-1/2 inch ones, so I had to do something about
  237.    it!
  238.  
  239.  
  240. 1.12 --- 12/21/90
  241.    Squashed a nasty bug where diskettes using 12 bit FATs having large
  242.    sub-directories were not being processed correctly.  The bug caused
  243.    spurious errors ranging from outlandish garbage being printed to a
  244.    complete system lock-up (big red switch time)!
  245.  
  246.    Annihilated an ugly bug which would occasionally cause a random
  247.    branch while the program was running under a DOS version prior to
  248.    the preferred 4.01.  This would normally lead to a complete system
  249.    lock-up.
  250.  
  251.    Since these problems were diagnosed on the winter soltice, I feel
  252.    completely justified in blaming it on Druids who obviously invaded
  253.    and started hacking with my code!
  254.  
  255.  
  256. 1.11 --- 12/15/90
  257.    Corrected programmer's stupidity where running the program with no
  258.    disk drive parameter (I always tested using drive B: --- honest! I
  259.    swear!!) would issue a warning message about extraneous characters.
  260.  
  261. 1.10 --- 9/1/90
  262.    Introduced support for 32 bit FATs, along with the more mundane (12
  263.    and 16 bit) varieties.  (Now if only I could find a diskette with a
  264.    32 bit FAT!)  Have you ever wondered what a CVR sheet for a 80 Meg
  265.    fixed disk would look like?
  266.  
  267. 1.00 --- a long time ago (in a galaxy far away)
  268.    Convert a perfectly good program (written in Pascal) into "C" for no
  269.    apparent reason, and decided foolishly to distribute it within the
  270.    "shareware" community.  What a maroon!
  271.  
  272.